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OVERVIEW 

The disk you have received contains the utility programs which make up 
PowerSOFT's Toolbelt for the TRSDOS 6.x™ operating system on the TRS-80™ Model 
4 They comprise a powerful set of utilities originally introduced for the Models I and 
III computers running under LDOS™. These utilities enable you to do a variety of 
tasks on disk files and memory, such as direct modification of disk sectors (PMOD6), 
checking and fixing directory errors (PCHECK6 and PFIX6), testing your disks for 
CRC and other formatting errors (PVU6), reformatting your TRSDOS 6.x™ or LDOS™ 
disks without losing any data already there (PREFORM6), searching for a particular 
string, byte or word value in a file or in an entire disk (PFIND6), and comparing two 
files or disks for differences (PCOMPAR6). 

In addition, PFILT6/FLT is a general-purpose filter program which is 
user-definable, and which adapts itself for either input or output, depending on the 
device to which it is attached. The filter files may be created using the BUILD 
library command. Two example files, CODE/JCL and DECODE/JCL, are given to 
demonstrate how PFILT6 can be used. Have you ever wanted to use the DVORAK 
keyboard layout everyone is talking about? You may make use of PFILT6/FLT to 
achieve the same results using the filter file DVORAK/JCL. 

Disk drive head movement may be tested and exercised with PEX6, the 
all-purpose disk stepper exerciser. You may use this program in conjunction with a 
cleaning disk for more effective head cleaning (but use it sparingly!). 

Tired of using a bulk eraser you don't dare bring close to the computer? 
PERASE6 will do the job for you. It will absolutely remove all traces of data and 
formatting information from a diskette. 

If you just want to kill files from a diskette as fast as possible, the versatile 
PKILL6 utility will let you do so, in a variety of ways. You may specify files to be 
killed by class, category, or else provide a list. Much more versatile that the PURGE 
library command, and much faster. 

If you need to know where on a diskette a certain file resides, PMAP6 will tell 
you. Conversely, if you want to know what file a certain sector on the disk has been 
assigned to, if any, PSS6, the Sector Status utility, will provide the information. 

PMOVE6 will allow you to move several files from one disk to another at the 
fastest possible speed. You may specify a list of files to move. This utility fills in 
the gap between a Backup-by-class and a full Backup - that is, the case when you 
have several files which don't have any common characteristics in their filenames 
that can be specified for a Backup-by-class. 

You've just received a TRSDOS™ 1.3 disk that you want to CONVert over to 
TRSDOS 6™, but you don't know exactly what's on it. Why bother booting it up to 
do a DIR, when PDIRT6 will show you the directory without having to leave TRSDOS 
6™ at all? 

Passwords can be removed from one or all files on a disk in one fell swoop by 
the PASSG06 utility. Very harfdy for those cases when you don't want to keep typing 
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user or owner passwords after each file. And this one won't even ask you for a 
master password! 

Directories and unassigned sectors on your disk can be cleaned up with the use 
of PCLEAR6. This utility will zero out the unused directory slots and unused sectors 
if desired. If you want to make sure absolutely no trace of a killed file remains on a 
disk for a hacker to find, use PCLEAR6. 

The following pages will give full detailed instructions on the use of each of 
these utilities and filters. Please read the instructions carefully before trying 
anything drastic. If you run into problems, merely pressing ENTER when any of the 
programs is prompting you for input will present a summary of the command syntax. 



LOADING INSTRUCTIONS 

The disk you have received is a standard TRSDOS 6 data diskette, formatted for 
40 tracks and double density. You should immediately make a backup of this disk and 
put the original away in a safe place against that inevitable day when you find that 
all your working copies have for some reason or other stopped working. 

TECHNICAL SUPPORT 

Please fill out the enclosed registration card and mail it at the earliest 
opportunity to: 

Breeze/QSD Incorporated 

17060 Dallas Pkwy, Suite 114 

Dallas TX 75248 

Registered owners of this package will be informed of any bug fixes and/or 
enhancements to the programs as they become available. 

If you have a problem with using any of the programs, please send a detailed 
description, including a complete description of your hardware setup and exactly what 
you were trying to accomplish, to PowerSOFT Technical Support at the address 
above. Include a self-addressed stamped envelope for a reply. PowerSOFT Technical 
Support will endeavor to answer all questions in a timely manner. 

If you have an urgent problem, you may call PowerSOFT Technical Support at 
(214)733-4475 between the hours of 10 a.m. and 5 p.m. CENTRAL TIME. Have all the 
necessary details ready. If possible, be at your computer. 
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USE WITH OPERATING SYSTEMS OTHER THAN TRSDOS 6 

The Toolbelt utilities will work on the Model 4 TRS-80™ under TRSDOS 6.x only . 
No other operating system for the Model 4 is supported. These programs will work 
under TRSDOS 6.x™; however they may or may not take advantage of the Model 4's 
wider screen, or extra memory. 

It is assumed that the user is familiar with the TRSDOS 6.x operating system 
and with details pertaining to the file and directory structure of TRSDOS 6. This 
manual is not a tutorial in these matters. For more information, consult the Model 4 
Technical Manual, available from Radio Shack. 



IMPORTANT NOTE 

These utilities have the numeral 6 appended to their filenames to differentiate 
them from the programs issued for the Model I and III under LDOS (e.g., PMOD6, 
PCHECK6). You may rename them to whatever you find convenient, however under no 
circumstances should the programs be mixed with those for the Models I and III! 



NOTATION 

To avoid confusion when reading the documentation, please make note of the 
following: 

This is a ZERO: 

This is ALSO a ZERO: D 

This is the letter 0: 
This is also the letter 0: 
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The PM0D6 Utility is a comprehensive Disk/File/Memory Modification Utility. It 
allows easy user interaction between memory and disk storage systems. All TRSDOS 
6™ supported disk devices may be operated on, including Single/Double Density, 
Single/Double Sided, 5" and 8" floppies and fixed/removable rigid disk systems. It has 
a full screen display of 256 bytes at a time with both HEX and ASCII formats, and 
makes use of dual cursors for easy modification. The user can go to the heart of a 
disk and modify in HEX, ASCII, DECIMAL, BINARY, or OCTAL input. The syntax of 
the PMOD6 command is: 



PMOD6 aaaa 
PMOD6 filespec, bbbb 
PMOD6 :c,d,e 

aaaa = memory address to modify 

filespec = any valid TRSDOS 6™ filespec 

bbbb = relative file sector (optional) 

:c = drive to modify (0-7, colon mandatory) 

d = cylinder number (defaults 0) 

e - sector number (defaults 0) 

abbr: NONE 



NOTE: It is recommended that you use SETKI before using entering PMOD6 so 
the control keys and screenprinter will be active. 

There are 3 modes of operation of the program as indicated by the command 
line: 

Memory Modify 

Enter the memory address where modification is to begin. You may enter the 
number in Hexadecimal, Decimal, Octal, or Binary by FOLLOWING the number with H, 
D, 0(or Q), or B respectively (for example, 4030H). Decimal is the default value if 
none of the above are specified. 
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After entering the address and pressing <ENTER>, you will view the contents of 
1 page of memory (256 bytes) starting at the specified address. Please refer to the 
following screen dump: 
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The far left column of the screen indicates the current modification BASE (HEX, 
DECimal, ASCii, OCTal, BINary), and the MEM indicates that you are in the memory 
modify mode. The next column is the 4 character HEX address where the data is 
that you are viewing. The center columns of the display is the HEX representation of 
the 16 bytes starting at the address indicated at the row beginning. There is a space 
between each quad (2 bytes, 4 HEX ASCII characters) for easier viewing. On the far 
right is the representative ASCII character of the 16 bytes on that row. All bytes 
less than 20H (32 decimal) are displayed as a period (.) to indicate a non-printing 
character. Graphics characters are also printed as periods in this illustration, however 
they will show up as graphics on your screen. You are now in the memory paging 
mode . Several keys are active at this point: 



BREAK 

M 

A 

B 

D 

H 

0,Q 

RIGHT ARROW 

LEFT ARROW 

UP ARROW 

DOWN ARROW 



restart the program 

enter MODIFY mode 

set ASCII modify 

set BINARY modify 

set DECIMAL modify 

set HEXADECIMAL modify 

set OCTAL modify 

increment displayed address by 1 byte 

decrement displayed address by 1 byte 

increment displayed address by 1 page 

bytes) 

decrement displayed address by 1 page 



(256 
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SH. UP ARROW display the top page of memory. If high 

memory is protected, this will display the 
FIRST PAGE of protected memory . 

SH.DOWN ARROW display the lowest page of memory 

(SHIFT-DOWN ARROW-Z if KI/DVR is active). 



Disk Modify 

Enter a Drive, Cylinder, and Sector where modification is to begin. You must 
precede the drive number with a colon (:) to distinguish it from a memory address 
(e.g., :1). The cylinder and sector numbers default to if not issued. The cylinder 
may be answered with the at symbol (@) to page directly to the directory track. 

After answering the prompt and pressing <ENTER> the specified sector will be 
read from disk and displayed on the video. Please refer to the following screen dump: 

00.0506 5146 4220 2020 D102 DD52 ED73 8D56.EFQFB AB3R.S.V 

HEX 1D.E5CD A460 E12B E53A 124D 32D7 5C21 0D47 . . . . 3 . + . : R32G\ ! 3G 

DRV 20.1171 5601 5000 EDB0 E1E5 237E FEDE 380D . Q . VAP3 . . . . #~ . N8M 

4 30.FE28 20F6 1127 S6CD 5444 C21E 56E1 117E..C . Q > \J . TD . ^ . Q~ 

CYL 40.56CD 7255 C21E 5621 1157 CD67 4411 7E56 . V . rU . ^ ! QU . gDGTV 

000 50.1AB7 2010 0601 21A? 57CD AC55 DA00 5CCD.Z. PFA ! . U . . U . 3\ . 

SEC 60.7155 18E? 1347 1AB7 2815 B820 0B21 2B58 . qUX . SGZ . ( U . K ! +X 

006 70.CD67 44CD 6356 18D5 131A B720 ED18 1CD5 . . gD . cVX . SZ . .X\. 

80.060A 21B? 57CD AC55 DA00 5CCD 7155 D12S . FJ ! . U . . U . 3\ . qU . ( 

70.BCAF 1221 075? CD67 4418 B22A 7C56 7DB4 . . . R ! GY . gDX . * ! V} . 

3TD A0.282D 3A76 563D 200? 2158 58CD ?555 3277. (-: V V= I!XX..U2w 

B0.563A 7856 3D20 D921 7D58 CD?5 5532 7?S6.V=xV= I!}X..U2yV 

C0.3A7A 563D 2007 217? 58CD 7555 327B 563A.:zV= I1.X..U2CV: 

00,7756 2F32 7756 21E5 57CD 6744 CD4? 00FE . ujV/2ujV ! . U . gD . 13 . 

E0.01CA 005C FE0D 20F4 ED7B 8056 3A7E 56D6.A.3\.M . . { . V * ~V . 

F0.304F C5CD 4160 FDCB 035E C21A 56FD 2283 . 00 . . A3 . . C* , ZV . » . 

The screen format is similar to Memory Modify except for the far left column of 
data, which indicates the source of the information. You are given the drive, 
cylinder, and sector being viewed. You are supplied with the size of the drive (5" or 
8"), and if it is a Floppy or Rigid drive. If a floppy, you are given the density 
(single or double), and the number of sides (single or double). If a Rigid drive, you 
are told if it is Fixed or Removable. You are now in the sector paging mode . The 
following keys are active: 

BREAK restart program 

M enter MODIFY mode 

A set ASCII modify 

B set BINARY modify 

D set DECIMAL modify 

H set HEX modify 

0,Q set OCTAL modify 

0-9 page to corresponding sector 

@ page to current sector on directory track 

R restore drive to cylinder 0, sector 

RIGHT ARROW increment sector 

LEFT ARROW decrement sector 

UP ARROW increment track 
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DOWN ARROW 
SH. RT.ARROW 
SH. LEFT ARROW 
SH. DOWN ARROW 



SH. UP ARROW 



decrement track 

page to highest sector on current track 

page to lowest sector on current track 

page to lowest track on the current drive, 

same sector (SHIFT-DOWN ARROW-Z if SETKI 

is active) 

page to highest cylinder on disk, same sector 



File Modify 

Enter a filespec that you wish to view. You may optionally follow the filename 
with the relative sector that you wish to start with. After locating the file, the 
specified relative sector (default zero) will be read from the disk and displayed to 
the video. Please refer to the following screen dump: 
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The screen layout is similar to that of Memory Modify, except for the far left 
column. You are given the drive number that you are working on. The filename that 
you are viewing is displayed vertically starting just to the right of the cursor. Near 
the bottom you are given the relative sector you are viewing, and the end of file 
sector . Normally, you will only be able to view up to 1 less than the EOFS. You are 
now in the file paging mode . Several keys are active: 



BREAK 

M 

A 

B 

D 

H 

0,Q 

R 

RIGHT ARROW 

UP ARROW 

LEFT ARROW 

DOWN ARROW 



restart program 

enter Modify mode 

set ASCII modify 

set BINARY modify 

set DECIMAL modify 

set HEX modify 

set OCTAL modify 

rewind to relative sector of file 

increment to the next relative sector 

same as right arrow 

decrement to next relative sector 

same as left arrow 
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SH. UP ARROW 



prompt for a new relative sector within file 
to display 



NOTE: When using the FILE MODIFY option on DIR/SYS, the sectors will NOT 
be written as Read-Protected, making it unreadable to TRSDOS 6™ for all intents and 
purposes and requiring a "Repair (alien)" after updating back to the disk. Use the 
DISK MODIFY option to correctly handle the directory track. 



Modify Mode 

The MODIFY mode is common to all of the above 3 modes of operation, and is 

entered by pressing M when the desired data is being viewed in one of the above 

paging modes. The cursor will move into the HEX and ASCII portions of the display 

(dual cursors), and will flash very rapidly. Refer to the following screen dump: 
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At the top left of the display, you are given the relative byte within the 
displayed data where the cursor lies . The following keys are active at this point: 



BREAK 



ENTER 



SHIFT CLEAR 



abort the modify mode, re-read the source data as it was 
before any changes were made, and return back to the 
paging mode you came from. NOTE: In the MEMORY mode, 
the changes are immediate, and cannot be re-read. In this 
case, the BREAK key is identical to pressing the ENTER 
key. 

terminate the modify mode, and write the modified data 
back to the source with all changes, and return to the 
paging mode you came from. NOTE: Changes are immediate 
in the MEMORY mode, and control is merely passed back 
to the paging mode. 

allows you to change the modification mode BASE without 
leaving modify mode. You will have a new flashing prompt 
in the left column of the display. Enter A, B, D, H, or 
(or Q) to set ASCII, BINARY, DECIMAL, HEX, or OCTAL 



TOOLBELT Utilities 

®1983 by Breeze/QSD, Inc. 

Page 8 



bases respectively. Any other keys will" be ignored. You will 

then return back to the modify mode at the same location 

you came from. 
ARROW KEYS move the cursor 1 byte in the corresponding direction 

without affecting any of the bytes. 
SHIFT ARROW KEYSmove the cursor to extreme row or column ends in the 

associated direction without affecting any of the bytes. 

NOTE: In the DISK MODIFY and FILE MODIFY modes you will not be able to 
move the cursor beyond the edges of the displayed data. In MEMORY modify, if you 
attempt to move the cursor beyond the edges, additional data is brought to the 
screen to supply the desired information. 

If you are in the ASCII MODIFY mode , and the key you enter does not apply to 
any of the above conditions, then that character is entered at the current cursor 
location, and the cursor is advanced by one byte. 

If you are NOT in ASCII modify, several additional features are available: 

Q - position the cursor to the last byte of the currently displayed page. 
S - position the cursor to the first byte of the currently displayed page. 
G - followed by a number moves the cursor immediately to the relative- byte in 
the page that you are viewing. 

L - followed by a number moves the cursor to the next occurrence of the 

specified byte. The cursor will move to the last byte on the screen if 

the requested byte is not located. 
+ - followed by a number positions the cursor that many bytes FORWARD from 

its current position. 
- - followed by a number positions the cursor that many bytes BACK from its 

current position. 
P - followed by a number duplicates (propagates) the current byte located under 

the cursor to the following indicated number of bytes. 
< - will shift all bytes from the cursor to the page end by one byte, and place a 

zero at the last location on the screen. This allows you to delete text 

at the cursor. 
> - will shift all bytes from the cursor to the page end by one byte, and place a 

zero at the current cursor location. This allows you to insert text at 

the cursor. 
Z - fills the data buffer with ZEROES starting at the current cursor position. 

The above commands are disabled in the ASCII MODIFY mode, and will merely 
insert the character into the text. 

If you are not in ASCII modify, and none of the above conditions are met, then 
the input is interpreted as numeric input. If you are in HEX mode, for example, you 
must enter two HEX digits (0-9, A-F) to change a single byte. Decimal mode expects 3 
digits (0-9), Octal mode expects 3 digits (0-7), and Binary mode expects 8 digits (0-1). 
You may pre-terminate the numerical input by pressing ENTER. Thus, in HEX mode, 3 
<ENTER> is the same as entering 3, in Binary mode, 111 <ENTER> is the same 
as entering 00000111. When you are in the middle of entering a number, the 
cursor will change to indicate that more input is required to complete the current 
operation. If you enter incorrect digits before completing the number, entering an 
invalid character will terminate the entry. Thus, in HEX modify, you type a 3, but 
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meant to enter a 4, just hit an invalid key (X for example) to terminate the 
operation and leave the byte unchanged. In the .above special commands, G, L, P,„ + 
and -, the numeric input following the command must be in the current base. If you 
are in HEX modify, then G10 is a valid command to move the cursor to relative byte 
10H, but in DECIMAL modify, you must enter G016 to achieve the same results. 

Any key that does not meet any of the above conditions will be ignored. 

When first entering this program, the data source information may be entered 
directly from the TRSDOS 6™ READY command line, or will be prompted for if not 
supplied with the command. If you wish to examine a file that could be interpreted 
as an address (for example, AFCH/CMD or D0123/TXT), you may precede the 
filename with an exclamation point (!) to force PMOD6 to interpret it as a filespec. 
For example, PMOD6.F000H will display memory address F000H, but PMOD6,!F000H 
will display the file F000H. Alternatively, you may attach a drive specification to the 
file name to force it to be treated as such, for example, F000H:0 will be seen as the 
file 
F000H on drive zero rather than the address F000H. 
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PCHECK6 



The PCHECK6 Utility is a comprehensive directory check utility. It allows the 
user to completely check the integrity of disk storage systems. All TRSDOS 6™ 
supported disk devices may be operated on, including Single/Double Density, 
Single/Double Sided, 5" and 8" floppies and fixed/removable rigid disk systems. This 
program will locate and report any inconsistencies in the directory information of a 
disk. In conjunction with PFIX6, most directory problems can be easily corrected 
without extensive knowledge of how directories are formatted. The syntax of the 
PCHECK6 command is: 



PCHECK6 *,:a 
PCHECK6 *,files P ec 

:a - drive number to check (colon optional) 
filespec - any valid TRSDOS 6™ filespec 

an asterisk (*) preceding the parameters will 
send the output to the video and printer 

abbr: NONE 



After selecting the mode of operation (full disk or file), the entire directory of 
the indicated disk is read into memory. If not enough memory is available, it will be 
reported, and the program will abort. If any errors occurring during the directory 
read, they will be reported, and the program will pause and allow you to select a 
R>etry, S>kip, or A>bort. Although it is possible to check even an unreadable 
directory, unpredictable errors may be reported. For the normal operation of this 
program, it is assumed that all sectors of the directory are readable , even though the 
data contained therein may be incorrect. 

Each file specified is passed through a three stage check. This will either be the 
single file specified, or all files if an entire disk is specified. In the first stage, the 
integrity of the files' directory entry is checked. In the second stage, the associated 
HIT table bytes are checked. In the third stage, the associated GAT table bytes are 
checked. When all specified files have been checked, and all errors have been 
reported, a total error count will be issued and the program will exit back to 
TRSDOS 6™. 

The utility PFIX6/CMD is capable of fixing most errors that may be reported by 
PCHECK6. 

The following is a list of the possible error messages that PCHECK6 may report. 
A technical section will follow that will describe the logic used by PCHECK6, and 
probable causes for the error conditions. 
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ERROR MESSAGES 

1. Cylinder xxx has an invalid GAT table byte 

2. HIT byte at xxH invalid or extraneous 

3. Filename contains non-ASCII characters 

4. End of File Sector beyond allocated sectors 

5. No terminator for extent field 

6. Directory links to record not linking, back to it 

7. Track assigned that is beyond diskette boundary 

8. Extension assigned before end of extents 

9. Forward link to inactive entry 

10. Forward link to non-extension entry 

11. Extension record not assigned to any files 

12. Multiple files assigned to single granule 

13. Directory record has invalid HIT byte 

14. Directory record has a zero HIT byte 

15. Extended directory record has invalid HIT byte 

16. Extended directory record has a zero HIT "byte 



Directory Check Logic 

This section contains the logic that PCHECK6 uses to determine the correctness 
of the directory. The novice user need not be concerned with this information as it 
is offered only as technical reference for the advanced user. 

During passes 1-3, if an error is found, it is reported in the following format: 

filename/ext @ Directory Sector xx, Relative Byte xxH. 
"error message string" 

If a non-ASCII character is found in the filename, its position will be highlighted 
with a graphic block. In all errors reported in the above format, the directory 
location will refer to the primary directory record, regardless of where the error 
occurred along the file. 



Pass ttl 

Check to be sure that all 11 bytes of the filename contain characters within the 
range of 20H to BFH (printable ASCII characters). If any are found to be outside 
this range, report error 3. The offending characters are displayed as a graphic block 
to aid in identifying their positions. 

The 5 extents of the associated record are each checked on a sector by sector 
basis. If any extent points to a track that is beyond the diskette boundary, an error 
is reported. 

If all 5 extents have been parsed, and no terminator is found (FEH or FFH) then 
error 5 is reported and the program terminates. 
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If an extended record is found, and it is not at the 5th position in the extent 
field, error 8 is reported and the error scan continues. 

If the extended record is found, locate its position in the directory. If bit 4 of 
the first byte in the record is not set (inactive file), error 9 is reported and the 
program terminates. If bit 7 is not set (not an extension), error 10 is returned and 
the program terminates. The second byte in the extended record is a link back to 
the previous record. If this byte is incorrect, error 6 is reported and the program 
terminates. 

This process continues until an FFH terminator is reached, or a terminal error is 
found. 

When processing is completed, the number of sectors assigned to the file is 
calculated and compared to the end of file sector in the directory record. If the end 
of file is larger than the allocated records, error 4 is reported. 



Pass #2 

This pass checks the integrity of the associated HIT byte for the current file. 
Each file is traced from its primary directory entry through all extents until an FFH 
terminator or a terminal error is reached. 

If the primary directory entry contains an invalid HIT byte, PCHECK6 returns 
error 13 and continues. If the primary directory entry contains a zero HIT byte, 
error 14 is returned. 

If an extended directory record contains an invalid HIT byte, error 15 is 
returned. If an extended record contains a zero HIT byte, then error 16 is reported. 



Pass S3 

This pass checks the integrity of the associated GAT bytes for the current file. 
As with pass 2, each file is traced through all of its extents. 

If the current granule has already been allocated (either by itself or another 
file), then error 12 is displayed. NOTE: Only a single error 12 will be reported for a 
single file even though there may be several occurrences of it. 



When these steps have all been completed, and a single file has been specified, 
the number of errors will be reported and an exit will be made back to TRSDOS 6™. 
If an entire disk is specified, three additional checks are made on the directory. 



Check ttl 

When Pass #1 is made in the above process, it checks every directory record 
that has bit 4 set and bit 7 NOT set (active primary directory record). As the 
current file is being checked, bit 5 of all the associated directory primary and 
extended records is set to indicate a completed file. During the Check #1 phase, the 
entire directory is re-scanned. If any files' have bit 4 set, and not bit 5, then bit 7 
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MUST be set or error 11 is reported. This condition indicates an extended directory- 
record that has not be linked to any primary record (an extraneous directory record). 
This condition could result if one of the above passes terminates on a fatal error 
and an extension is not checked. If no terminal • type errors are reported, but error 
11 was issued, then there is an extra record in the directory that is not associated 
with any files. 

Check tt2 

As the program processes pass #2, it completely builds a second HIT table in 
another buffer. During the check #2 phase, the computed table is compared byte for 
byte with the HIT table as read from the diskette. If any of the bytes do not 
match, then error 2 along with the relative byte of the mismatch is displayed. If 
none of the pass #2 errors are reported, but error 2 is issued, then there is an extra 
byte in the HIT table at the corresponding location. 

Check tt3 

As the program processes pass #3, it completely builds a second GAT table in 
another buffer. Before check 3 is made, the disk lockout table is overlaid onto the 
built GAT table so that locked out tracks will not be counted. During the check #3 
phase, the computed table is compared byte for byte with the GAT table as read 
from the diskette for as many tracks as there are on the disk. If any of the bytes 
do not match, error 1 and the relative cylinder of the mismatch is returned. If none 
of the pass #3 errors are reported, but. error 1 is issued, then there are extra grans 
allocated on the disk that are not assigned to any files. 

Sometimes, one type of an. error will inherently cause another type of error. In 
these cases, fixing even one error may correct several others. As an example, if 
there is no terminator for a record, chances are that error 12 will be reported also. 
If a terminal error is found in a directory link to an extension, error 2 may also be 
reported. 

When using this utility on Rigid drives, there is one error that may be reported 
that should be considered normal. TRSDOS 6™ sets aside an extra track right next to 
the directory, and shows this track as allocated in the GAT table. This track is used 
by the Laredo and Radio Shack hard drive systems as overhead, and should not be 
used. PCHECK6 may report an invalid GAT Table Byte at this track location, and it 
should be considered normal. The Laredo or Radio Shack rigid drive user should be 
aware of this problem, especially as it relates to the PFIX utility, which may 
de-allocate this track, or allocate it to an unassigned file. 

Similarly, using PCHECK6 on a Model I double density system disk with a SOLE 
track will result in an "Invalid GAT byte" error. This is because the SOLE 
modification system allocates track to prevent the system from attempting to use 
non-existent sectors on it. This error should be considered normal and should not be 
fixed. 
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PFIX6 



The PFIX6 program is a comprehensive directory repair utility. It allows the user 
to completely repair most directory problems, and also has the ability to transfer a 
faulty boot sector from a good disk. All TRSDOS 6™ and LDOS 5.1.x supported disk 
devices may be operated on, including Single/Double Density, Single/Double Sided, 5" 
and 8" floppies and fixed or removable rigid disk systems. This program will locate 
and repair most inconsistencies in the directory information of a disk. In conjunction 
with PCHECK6, most directory problems can be easily located and corrected without 
extensive knowledge of how directories are formatted. The syntax of the PFIX6 
command is: 



PFIX6 :a,G,H,F,B=:d,L,R,P 

:a = drive number to fix (colon optional) 

G = repair GAT table 

H - repair HIT table 

F =* repair missing/invalid File data 

B = repair BOOT sector 
:d = take boot sector from this drive 
(mandatory if B is specified) 

L = indicates a LAREDO rigid disk system 

R - indicates a RADIO SHACK rigid disk 

P = prompt for cyls, density, sides 

(should be last parameter specified) 

At least ONE parameter MUST be specified. 

abbr: NONE 



After selecting the desired parameters, the entire directory of the indicated disk 
is read into memory. If the P option is not specified, the program will use the 
information supplied by TRSDOS 6™ defining the diskette cylinder count, number of 
sides, and density. This information is located in the GAT sector of the diskette at 
format time. If it is possible that this particular information is invalid, use the P 
option, and you will be prompted to enter these . parameters. If, for example, the 
entire GAT sector is zeroed out, TRSDOS 6™ will report this to be a "xxxxxx 
density, single sided, 35 track" disk. If the GAT is fixed using these parameters, and 
the disk is REALLY a 40 track disk, the corrections will be inaccurate. 

If not enough memory is available, it will be reported, and the program will 
abort. If any errors occurring during the directory read, they will be reported, and 
the program will pause and allow you to select a R>etry, S>kip, or A>bort. Although 
it is possible to repair even an unreadable directory, unpredictable errors may be 
generated. For the normal operation of this program, it is assumed that all sectors of 
the directory are readable , even though the data in them may be incorrect. 
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Each file of the directory is passed through a three stage process. In the first 
stage, the integrity of the files directory entry is fixed. In the second stage, the 
associated HIT table bytes are fixed. In the third stage, the associated GAT table 
bytes are fixed. When all specified files have been checked, and all errors have been 
corrected, the corrected data will be written back to disk per the command 
parameters. Either the GAT, HIT, file records, and/or BOOT sector will be updated 
to the disk. Although the entire directory is repaired in memory, only the requested 
data to be fixed is written back out to the disk. The utility PFIX6/CMD is capable 
of fixing most errors that may be reported by PCHECK6. 

If only the GAT and/or HIT are specified, and an error is found in any of the 
files directory records, the fix will abort and a message will be returned requesting 
you to use the "F" option. This is because it would be unreliable to repair a GAT or 
HIT when the root information is invalid. This is to prevent a user from 
inadvertently destroying any relevant data. 

The following is a list of the errors that PFIX6 can fix. A technical section will 
follow that will describe the logic used by PFIX6, and probable causes for the error 
conditions. 



'9 

10 

11 
12 
13 
14 
15 
16 



Cylinder xxx has an invalid GAT table byte 
HIT byte at xxH invalid or extraneous 
Filename contains non-ASCII characters 
End of File Sector beyond allocated sectors 
No terminator for extent field 
Directory links to record not linking back to it 
Track assigned that is beyond diskette boundary 
Extension assigned before end of extents 
Forward link to inactive entry 
Forward link to non-extension entry 
Extension record not assigned to any files 
Multiple files assigned to single granule 
Directory record has invalid HIT byte 
Directory record has a zero HIT byte 
Extended directory record has invalid HIT byte 
Extended directory record has a zero HIT byte 



Directory Repair Logic 

This section contains the Jogic that PFIX6 uses to repair the directory. The 
novice user need not be concerned with this information as it is offered only as 
technical reference for the advanced user. 

Pass #1 

Check to be sure that all 11 bytes of the filename contain characters within the 
range of 20H to BFH (printable ASCII characters). If any are found to be outside 
this range, replace with an "X". (If this occurs, a HIT repair will be required to 
access this file from TRSDOS 6™) 

The 5 extents of the associated file record are each checked on a sector by 
sector basis. If any extent points to a track that is beyond the diskette boundary, a 
terminator (FFH) is entered at the current 'location. 
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If any granules are indicated in a file's extents, and the corresponding GAT bit 
is set (assigned to a previous file), the record will be terminated at the current 
location. 

If all 5 extents have been parsed, and no terminator was found (FEH or FFH) 
then a terminator is entered at the last position. 

If an extended record is found, and it is not at the 5th position in the extent 
field, the error is ignored and the program continues. 

If the extended record is found, its position in the directory is located. If bit 4 
of the first byte in the record is not set (inactive file), the extension is unlinked. If 
bit 7 is not set (not an extension), it is also unlinked. The second byte in the 
extended record is a link back to the previous record. If this byte is incorrect, the 
extension is unlinked. 

The un-linking of the files is to protect against possible overlaying another file 
that does not in fact link back to the primary. By unlinking a file, data past the link 
will be lost, but the data will not accidentally be force-linked to an incorrect entry. 

This process continues until an FFH terminator is reached, or a terminal error is 
found and a terminator is forced. 

When processing is completed, the number of sectors assigned to the file is 
calculated and compared to the end of file sector in the directory record. If the end 
of file is larger than the allocated records, then force the number of allocated 
records into the end of file sector. 

Pass #2 

This pass constructs the HIT table. Each file is traced from its primary 
directory entry through all extents until an FFH terminator is reached. The entire 
HIT table will be reconstructed starting with a page (256 bytes) of zeroes. All active 
primary and extended directory records are logged correctly into this table. 

Pass S3 

This pass constructs the GAT table. As with pass 2, each file is traced through 
all of its extents. The entire GAT table will be re-constructed starting with all null 
characters. All active primary and extended directory records are logged correctly 
into this table. 

Sometimes, one type of an error will inherently cause another type of error. In 
these cases, fixing even one error may correct several others. As an example, if 
there is no terminator for a record, repairing this will sometimes correct a multiple 
files assigned to a single granule error. 

When using this utility on Rigid drives, there is one error that may be repaired 
that the user should be made aware of. TRSDOS 6™ sets aside an extra track (the 
location can vary), and shows this track as allocated in the GAT table. This track is 
used by the Laredo and Radio Shack hard disk systems as overhead, and should not 
be used. The PFIX6 utility will de-allocate this granule, as it is not assigned to any 
files. This is only on rigid drive systems, and cannot be detected via the DCT 
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parameters. Due to this situation, PFIX6 will allocate this track if the following 
conditions are met: 

1. The drive being fixed must be a Rigid drive. 

2. The GAT fix option must have been specified. 

3. The GAT entry for the required cylinder (middle track for the Laredo, Track 
1 for the Radio Shack rigid disk) must be a null byte (not allocated to any 
files) after the GAT re-build. 

4. The L or R option must have been specified. 

If these conditions are met, then the extra track is automatically allocated. This 
could essentially lock-out an available track on a non-Laredo or non-Radio Shack rigid 
disk system, but will cause no other problems. If you are not sure if your rigid 
system uses this cylinder or not, then please consult the manufacturer or Logical 
Systems Inc. It is better to lock out a cylinder than crash the system. 
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F*REFOFtlVI6 



The PREF0RM6 utility is a disk Re-Formatter program. It allows the user to 
easily repair "sector not found" and "CRC errors". Only 5" Floppy Disks may be 
operated on, including Single/Double Density, Single/Double Sided disk systems. The 
syntax of the PREFORM6 command is: 



PREFORM6 :a,b,c 

:a = drive to be re-formatted (0-7) 
b = Y or N (pause on faulty sectors) 
c = starting cylinder (default 0) 

abbr: NONE 



When the desired parameters have been selected, the specified drive will be read 
to determine the diskette type (cylinders, density, sides). If there is not enough 
memory for the re-format utility to operate, the program will abort with an error 
message. If memory is sufficient, then the re-format operation will proceed as 
follows: 

The current track will be read into memory sector by sector. 

The track will be formatted. 

The track will be re-written back sector by sector. 



If any errors occur during any of the 3 steps, and the Y option was specified, 
you will be issued an error message, and allowed to R>etry, S>kip, or A>bort. If the 
N option was specified, processing will continue with no error messages. When the 
entire disk has been re-formatted, the directory track will be read into memory, and 
written back with the proper read-protect data address marks. 

If you wish the program to abort, you may press the BREAK key, and the 
routine will terminate after the current track has been completed. This will allow 
normal termination of the program. Pressing the RESET button to abort the program 
is not recommended, as the current track may be totally lost. If the program is 
aborted, and the directory track has already been re-formatted, it will not be 
read-protected. In this case, you must issue a "repair (alien)" command to gain access 
back to the diskette. 

If any CRC errors existed on the diskette, they will be corrected (if the media 
is OK). If any NOT FOUND errors existed on the diskette, they also will be 
corrected, but the previous contents of the sector will be completely lost. This will 
allow the diskette to be reused with minor losses. If the faulty sector was on the 
directory track, it is possible that some files records may have been lost also. It is 
strongly recommended that the user make frequent backups of valued data in order to 
minimize losses resulting from disk errors. If sectors are lost during the re-formatting 
process, it is advised that the user recopy the programs that were assigned to the 
faulty sectors. The PSS6 utility will assist the user in resolving this. 
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This program will also "freshen" a diskette. Formatted diskettes have a "shelf" 
life of about 5 years according to most manufacturers. By re-formatting a diskette, 
the data will be strengthened, and the shelf life will be extended. If all sectors are 
readable before re-formatting, then no loss of data will occur. 
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F»VUT6 



The PVU6 program is a comprehensive disk verification utility. It allows the user 
to easily locate and identify faulty sectors on a disk. All TRSDOS 6™ supported disk 
devices may be operated on, including Single/Double Density, Single/Double Sided, 5" 
and 8" floppies and fixed/removable disk systems. The syntax of the PVU6 command 
is: 



! PVU6 :a,b,c 
f 

! :a = drive to be verified (0-7) 

! b = Y or N (pause on faulty sectors) 

! c = starting cylinder (default 0) 

! 

! abbr: NONE 



When the desired parameters have been selected, the specified drive will be read 

to determine the diskette type (cylinders, density, sides). Each cylinder will then be 

read sector by sector. If any errors are found, and the Y (pause) option was given, 
you will be given the option to R>etry, S>kip, or A>bort. 

When the disk verification process has been completed, you will be given the 
number of sectors checked, and the number of sectors that were not read 
successfully. If there were bad sectors, you will be prompted to press ENTER for 
the list of faulty sectors. Each bad sector will then be listed to the video. 
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PCLEAR6 



The PCLEAR6 program is a comprehensive disk clean-up utility. It allows the 
user to easily erase unassigned granules and directory records. All TRSDOS 6™ 
supported disk devices may be operated on, including Single/Double Density, 
Single/Double Sided, 5" and 8" floppies and fixed/removable disk systems. The syntax 
of the PCLEAR6 command is: 



PCLEAR6 :a,D,S,b 
PCLEAR6 filespec, b 

:a = clear this drive (colon optional) 
D = clear unused directory records 
S = clear unassigned sectors 
filespec - any valid TRSDOS 6™ filespec 
b = fill command (default 00H) 
fill = #cc (numeric value) 
- "cc" (ASCII string) 

(numbers and ASCII can be mixed) 

abbr: NONE 



After selecting the desired parameters, one of the following routines will be 
executed. 

If a disk was specified to be cleared: 

If the S option was given, the directory GAT table will be read into memory. All 
non-allocated sectors will be written to with the defined fill data. If the D option was 
given, then all directory records that do not have bit 4 set (i.e., inactive records) 
will be set to all zeroes. 

If a file was specified to be cleared: 

All sectors assigned to the file will be written to with all the defined fill data. 
This will destroy all data belonging to the file. 

The user may optionally define what data is to be written into the empty 
sectors. The default value is zero (00H). A single pound sign (#) followed by a one 
byte numerical value (0-255) to be used as the fill byte. The number may be entered 
in Binary, Decimal, Hex, or Octal by preceding the number with B, D, H or 
respectively (default decimal). A quotation mark (") followed by a string will copy this 
string repetitively into the empty sectors. Numerical values and strings may be 
intermixed. 
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Examples: 

PCLEAR6,:0,d,s,#h40 

Fill all unassigned granules with sectors filled with the byte 40H, and clear all 
unused directory records. 

PCLEAR6,deadfile/cmd:3,"nosy aren't you!" 

Fill all sectors currently assigned to file "deadfile/cmd" with the repetitive string 
"nosy aren't you!" 

PCLEAR6,:7,s,#95,"Kim was here" 
Fill all unassigned granules with the string "Kim was here" preceded by the 
cursor character (ASCII 95 decimal). The terminating quote may be left out if it is 
the last character on the line. 

When a file is killed with TRSDOS 6™, several actions occur. First the first byte 
of all primary and extended directory records is set to 00H. All granules assigned to 
the file are released and made available in the GAT table. All primary and extended 
directory records have their corresponding HIT bytes set to 0. 

This will REMOVE a file, and make it inaccessible to TRSDOS 6™, but all the 
information is still there. The directory record is still in the directory, but it is 
indicated as inactive by the system. All data that was assigned to the file is also 
still on the disk. Only the directory record has been changed, none of the data has 
been touched. At this point, a couple of minor changes to the directory can reinstate 
the file and make it totally available again with full access to the data. 

By running PCLEAR6 on a drive, you may safely remove all traces of both the 
files data, and it's associated directory record. If you have a disk that has been 
used several times, chances are that several "killed" files are still on the disk. If 
this disk was given to a programmer, chances are that the data could be "unkilled". 
PCLEAR6 will make sure that even the best programmer cannot access any of the 
killed files on your disk, because the information has been completely removed from 
the disk. 

The FILE option of PCLEAR6 is a very powerful feature, but could be disastrous 
if you are not careful. This will totally erase all data assigned to the file. Each 
sector will contain the specified fill data. This routine could be useful to set all 
bytes of a file to a known initial value to be used as a data file. 
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PSS6 



The PSS6 program is a Sector Status Utility. It allows the user to easily 
identify which file is assigned to any sector on a disk. All TRSDOS 6™ supported 
disk devices may be operated on, including Single/Double Density, Single/Double 
Sided, 5" and 8" floppies and fixed/removable disk systems. The syntax of the PSS6 
command is: 



! PSS6 :a,b,c 

t 

! :a - drive number (0-7, colon optional) 

! b = cylinder number 

! c = sector number 

! 

! abbr: NONE 



When ' the specified parameters have been entered, PSS6 will read the designed 
directory. If not enough memory is available, PSS6 will abort with an error message. 
Otherwise, the drive type will be displayed along with the name, date, and number of 
free granules on the mounted diskette. If the sector is not assigned to any files, an 
appropriate message will be displayed, and an exit made back to TRSDOS 6™. If it is 
assigned, the filename, and the relative sector number in the file will be returned. 
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PMAP6 



The PMAP6 utility is a comprehensive disk/file mapping program. It allows the 
user to easily locate sectors belonging to particular files and determine the status of 
all granules on a disk. All TRSDOS 6™ supported disk devices may be operated on, 
including single/double density, single/double sided, 5.25" and 8" floppies and 
fixed/removable hard drive systems. The syntax of the PMAP6 command is: 



PMAP6 *,:a 
PMAP6 *,filespec 

* = send output to printer 
:a = map this drive 
filespec = any valid filespec 

abbr: NONE 



Mapping a drive: 

The GAT table of the specified diskette will be read into memory. Each cylinder 
will be mapped granule by granule. The display will show the cylinder number, and a 
list of all the granules on a sector basis. An example of a single density, single 
sided disk could be: 

Cylinder 00: 00-04xx 05-09xx 



The first x position will indicate the status of the Allocation Bit associated with 
gran, and the sectors 00-04 indicate the range of sectors in the first gran. This 
position will display a graphic block if the corresponding granule is assigned, and a 
period if the granule is currently available. The second x position indicates the 
status of the corresponding Lockout Bit for the gran. This position will display an X 
if the corresponding granule is locked-out, or a space if it is available. All granules 
indicating locked-out status should also have the corresponding allocation bit set. 

NOTE: Rigid drives do not have a lockout table, so that information will not 
given. 

The display will pause each screenful and wait for you to press a key to 
continue. Press BREAK to abort at any time, or SHIFT @ to pause the display 
manually. This procedure will continue till all cylinders have been displayed. 



Mapping a File: 

The associated directory record for the given file will be read into memory. All 
sectors assigned to the file will be traced through the directory manually. The 
current sector that is being operated on will be displayed to the video (or printer if 
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specified). An attempt will be made to read each sector as it is computed. If the 
sector was read successfully, it will be surrounded by a thin line (ASCII 95). If a 
read error was issued by the system, the cylinder and sector number will be 
surrounded by graphic blocks. At any time, you may abort by pressing BREAK, or 
pause by pressing SHIFT @. This procedure will continue until the end of file is 
reached, and an exit is made back to TRSDOS 6™. 
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PASSG06 



The PASSG06 program is a comprehensive password removal utility. It allows the 
user to easily remove passwords on a single file or an entire diskette. AH TRSDOS 
6™ supported disk devices may be operated on, including Single/Double Density, 
Single/Double Sided, 5" and 8" floppies and fixed/removable disk systems. The syntax 
of the PASSG06 command is: 



PASSG06 :a,V,I,S,N ! 

PASSG06 filespec ! 

J 

:a = remove all passwords this drive ! 

V = include VISIBLE files (default) ! 

I - include INVISIBLE files ! 

S = include SYSTEM files ! 

N = exclude -visible files ! 
filespec - any valid TRSDOS 6™ filespec 

abbr: NONE 



Once the specified parameters have been entered, one of the following 2 routines 
will be performed: 

If an entire disk is specified, all files that are included by the command will 
have both their OWNER and USER passwords set to nil (8 spaces), and the protection 
level will be set to 0. The diskette master password will also be set to PASSWORD. 

If a single file has been specified, then that file will have its USER and OWNER 
passwords set to nil, and the protection level will be set to (full access). If a 
password currently exists for the file, it must be supplied with the command for the 
password to be stripped off. In this case the following two commands would be 
identical: 



PASSG06 filename/ext.password:d 

ATTRIB filename/ext.password:d (user=,owner=,prot=full) 
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PKILL6 



PKILL6 is a comprehensive multiple-file purge utility which allows the user to 
quickly and simultaneously kill several files from a disk. Files to be killed may be 
classified using partspecs or the standard categories of Visible, Invisible or System. 
Alternatively, a list of files to be killed may be supplied on the command line when 
the utility is invoked. PKILL6 may be used on all TRSDOS 6™ supported disk devices 
including 5" or 8" single/double sided, single/double density floppy disks and rigid 
drives. The syntax of the PKILL6 command is: 



files 



PKILL6 :a,!,V,I,S,N,A,L,R,/ext,$wild 
PKILL6 :a,Vext,filel,file2,file3 

:a = drive number, 0-7 (colon optional) 
! = erase directory entry of affected 
V = Include VISIBLE files (default) 
I = Include INVISIBLE files 
S - Include SYSTEM files 
N = Exclude visible files 
A = Include ALL files 
L - LAREDO rigid disk in use 
R - RADIO SHACK rigid disk in use 

/ext = include files with this extension 

$wild= Include files starting with the characters 
"wild" 

* = kill all files in the list following 

this asterisk (supply default 
extension if needed). 

Abbr: NONE 



PKILL6 allows the user to quickly and simultaneously kill several files from a 
disk. The files to be killed may be classified according to the standard categories 
V(isible), I(nvisible) and S(ystem), or may be files with a common extension, or files 
which begin with a particular set of characters. Files which have NO common 
characteristics may also be killed by entering an asterisk (*) followed by a list of 
filenames. The filenames may be assigned a default extension if needed. All TRSDOS 
6™-supported disk devices are supported by PKILL6, up to and including hard drive 
systems. When using PKILL6 on a hard drive system, the L (for Laredo systems) or R 
(for Radio Shack systems) parameter must also be supplied to inform PKILL6 that it 
is dealing with a rigid disk system that requires a track locked out for system use. A 
colon is optional when specifying a particular drive number. 

After the user selects the desired parameters, PKILL6 reads the directory track 
of the target disk into memory and proceeds to kill the necessary files. It then 
writes the now-modified directory back onto the disk. This procedure allows a very 
fast kill of multiple files. 

If the "!" parameter is not specified, the files are merely flagged as inactive in 
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the directory, leaving the possibility of later recovering a killed file. However, if "!" 
is specified, the entire directory entry for a killed file is zeroed out, making later 
recovery impossible. 



Any combination of the parameters V, I, and S are permitted by PKILL6. N and 
V are mutually exclusive. The use of the "A" parameter is a very good way to 
produce a data disk with a totally blank directory and the user should exercise 
caution when using it. 

When a list of files is supplied, an asterisk should be entered as the first item 
to inform PKILL6 that what follows is a list of files and not additional parameters. 
PKILL6 will kill each file in the list. 

Default extensions for files to be killed may be supplied by entering the 
extension after any file classification identifiers (S, I, V, etc) or in front of a list of 
files. In the latter case, the extension will be added to any filenames on the list 
which do not have explicitly typed extensions. To avoid having the default extension 
added onto a file, it must be entered as FILE/ to force a blank extension. 

If PKILL6 is typed in without any parameters, the user will- be prompted to 
supply them when the program starts. At this point the user may type in the 
necessary information. Up to 255 characters will be accepted. It may be useful, 
therefore, when entering a long list of filenames to simply enter PKILL6 and then 
type the list of names at the prompt. This is because the TRSDOS 6™ command 
buffer limits keyboard entry to only 80 characters. 

EXAMPLES: 

PKILL6 :0,I,/CIM 

This command will cause all visible and invisible files on drive with the 
extension /CIM to be killed. Note that since V defaults to ON, it is not necessary to 
type it in. 

PKILL6 :3,!,/DAT 

All visible files on drive 3 with the extension /DAT will be killed. The slots they 
occupied in the drive 3 directory will be zeroed out. 

PKILL6 :1,!,A 
This command will produce a totally blank data diskette on drive 1. All files 
except for BOOT/SYS and DIR/SYS will be killed and their directory entries zeroed 
out. 

PKILL6 :0,*,/cmd,test,test2,prog/bas,Foo/ 

The files TEST/CMD, TEST2/CMD, PROG/BAS and FOO will be killed. All the 
files must exist on drive 0. 
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F» C O Is/L F>A:R.6 



The PC0MPAR6 program is a comprehensive disk/file compare utility. It allows 
the user to locate inconsistencies between disks or files. All TRSDOS 6™ supported 
disk devices may be operated on, including Single/Double Density, Single/Double 
Sided, 5" and 8" floppies and fixed/removable rigid disk systems. The syntax of the 
PCOMPAR6 command is: 



PCOMPAR6 *,:a,b,c,d,:e,f,g ! 

PCOMPAR6 *,filel,file2,h ! 

1 

* = output to printer ! 

:a = source drive (0-7) ! 

b = source track (default 0) ! 

c = source sector (default 0) ! 

d = sector count (default to disk end) ! 

:e = destination drive (0-7) ! 

f = destination track (default 0) ! 

g = destination sector (default 0) ! 

filel, file2 - any valid TRSDOS 6™ filespec ! 

h = starting relative sector (default 0) ! 

J 

abbr: NONE ! 



After selecting the desired parameters, the source data will be loaded from disk 
one sector at a time, and compared to the specified destination sector. If any bytes 
do not match, their locations will be reported in the following format: 

:x, Cyl xxx, Side x, Sect xxx «==» :x, Cyl xxx, Side x, Sec xxx 
At Relative xxx (xxH) to yyy (yyH) for xxx (xxH) byte(s). 

Data Mismatch File Relative Sector xxxxx. 

At Relative xxx (xxH) to yyy (yyH) for xxx (xxH) byte(s). 

This will continue until all bytes in the sectors have been compared. When all 
sectors have been compared, the following will be displayed: 

xxxxx Total Sectors Compared, 
xxxxx Sectors Did Not Match. 
xxxxx+Bytes Did Not Match. 

The plus sign at the byte mismatch message will appear if more than 65535 
(FFFFH) bytes total did not match, otherwise it will be absent. 
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F"FIlSr06 



The PFIND6 program is a comprehensive string search and replace utility. It 
allows the user to locate and replace strings in memory, in a file, or the disk on a 
sector by sector basis. All TRSDOS 6™ supported disk devices may be operated on, 
including Single/Double Density,' Single/Double Sided, 5" and 8" floppies and 
fixed/removable rigid disk systems. This program will locate strings in several 
different formats, and upper/lower case independent searches may be specified. The 
syntax of the PFIND6 command is: 



PFIND6 *,@,:a,b,c,d,s,>t 
PFIND6 *,@ l filespec,e f s,>t 
PFIND6 *,@,ffff,gggg,s,>t 

* = output to printer 
@ = display match locations 
:a = drive number (0-7, colon optional) 
b = starting cylinder (default 0) 
c = starting sector (default 0) 
d = sector count (defaults to disk end) 
filespec = any valid TRSDOS 6™ filespec 
e = starting relative sector (default 0) 
ffff = memory start address 
gggg = ending address (default topmem) 
s = string to locate 
>t = replacement string (optional) 
string = "abcde????fgh" (literal string, case 
dependent) 

= 'abcde????fgh' (literal string, case 
independent) 

- abcde????fgh (? matches anything, case 
independent) 

= #,a,b,c (byte list) 

= ##,a,b,c (word list) 

abbr: NONE 



After selecting the desired parameters, the search will begin at the specified 
starting location. If a disk or file search is requested, the entire string must be 
contained wholly within a sector, as no spanning across sectors is done. If any 
matches are found, and the @ option is specified, their locations will be returned to 
the video, or the printer if the * option is given. If the @ was not issued, the 
location will be counted, but not displayed. If a replacement string was given, it will 
be written back to the source data. If any errors occur during either the read or 
write cycle, you will be issued an error message, and given the option to R>etry, 
S>kip, or A>bort. If a replacement string was specified that is longer than the source 
string, it will be truncated to the length of the source string. 
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The following types of strings will be accepted by the system: 

Literal string, case dependent: "string" 

By surrounding the string with quotation marks ("), it will be interpreted by 
PFIND6 as a literal string, no conversion of case will be made. Each letter specified 
must match exactly . This means that upper case and lower case are treated as 
separate characters. If the source string is "Kim" for example, then KIM will not 
match because the i and m are considered different characters. 

Literal string, case independent: 'string' 

By surrounding the string with apostrophes ('), it will be interpreted by PFIND6 
as a literal string, but all characters will be converted to upper case. When scanning 
for matches, each character of data is converted to upper case before the 
comparison is made. This will allow you to locate matches even if the upper/lower 
case characters do not match exactly. If the source string is 'Kim' for example, then 
KIM, kIM, kirn, etc. will all match. The upper and lower case characters are 
considered equal in this, type of search. 

? matches anything, case independent: str?ng 

This type of search is identical to the above mentioned example, except that any 
question mark characters (?) will match with any characters in the data searched. If 
there are no ? characters in the string, then this and the above would be identical 
in all respects. If the source string is K?m for example, then KIM, kIM, kirn, kam, 
kxm, etc. will all match. The upper and lower case characters are considered equal. 

Byte list: #,a,b,c 

This type of search will allow you to specify any string of bytes. The single 
pound sign (#) tells PFIND6 that a list of one byte numerical values will be following. 
The values may be made in Binary, Decimal, Hex, or Octal by preceding the number 
with B, D, H or respectively (default decimal). All numbers indicated must be in 
the range of 0-255 (0-FFH). 

Word list: ##,a,b,c 

This search allows a string of 2 byte words. The double pound sign (##) tells 
PFIND6 that a list of 2 byte numerical values will follow. The values may be in any 
number base following the rules in byte list. All numbers must be in the range of 
0-65535 (0-FFFFH). The numbers are placed into the string in LSB, MSB order. 

Sample Strings: 

"Kim Watt" becomes 4BH,69H,6DH,20H,57H,61H,74H,74H 
'Kim Watt' becomes 4BH,49H,4DH,20H,57H f 41H,54H,54H 
Kim Watt becomes 4BH,49H,4DH,20H,57H,41H,54H,54H 
tt,l,2,3 becomes 01H.02H.03H 
tf#,l,2,3 becomes 01H,00H,02H,00H,03H,00H 

If you are searching memory, the locations will be reported as follows: 

Memory Match at xxxxH 

If you are searching disk sectors, locations are reported as follows: 

Disk Match, Drive x, Cylinder xxx, Sector xxx, Relative Byte xxH. 
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If you are searching a file, then matches are reported as: 

File Match at Relative Sector xxxxx, Relative Byte xxH. 

The following are sample command lines: 

PFIND6,*@:0,'kim watt\>"Kim Watt" 
Searches drive from start to end. If the string 'Kim Watt' appears in ANY 
case, replace with the string "Kim Watt" in upper/lower case. If any matches are 
found, they will be displayed to the video and printer. 

PFIND6,:0,'kim watt' 
Searches drive from start to end. Reports the total number of occurences of 
the string 'Kim Watt'. Locations are not displayed, only the total number of matches. 

PFIND6,@PFIND6/cmd,kim watt 
Searches the file PFIND6/CMD for all occurrences of the string 'Kim Watt' in 
either upper or lower case, and list heir locations on the video. 

PFIND6,@sysO/sys,atf,h4411 

Searches the file SYSO/SYS for all occurrences of the binary word 441 1H 
(topmem Mod III), and reports their locations on the video. 

PFIND6,@h4000,#tt,h4411 

Searches memory from 4000H to TOPMEM for the binary word 441 1H, and 
reports the locations of all matches on the video. 
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PMOVE6 



The PM0VE6 utility is a comprehensive file copy program. It allows the user to 
easily transfer multiple files from one disk to another with a minimum amount of 
keystrokes. All TRSDOS 6™ supported disk devices may be operated on, including 
Single/Double Density, Single/Double Sided, 5" and 8" floppies and fixed/removable 
disk systems. The syntax of the PMOVE6 command is: 



! PMOVE6 :a,:b,/cde,filel,filel>file2 ! 

! PMOVE6 * ! 

! ! 

! :a = source drive number (0-7) ! 

! :b = destination drive (0-7) S 

! /cde = default extension for all files ! 

! filel,2 - any valid TRSDOS 6™ filespec ! 

! > = rename file to following filename, followed by ! 

! a list of files ! 

! ! 

! * = do not clear screen when asking for parameters ! 

! ! 

! abbr: PMOVE6,ab/cdefilel,file2 ! 



Once the desired parameters have been entered, the source and destination 
directories will be read to establish the disk types. The command line may be 
specified with the program name from the DOS command level, or you will be 
prompted for it. If entered from TRSDOS 6™, you will be limited to the 79 character 
input buffer. If prompted from the program, you will have a full 255 character buffer 
to specify the files. You may also optionally enter the asterisk character (*) as the 
first command, and the screen will not be cleared when the program initializes. If 
you have a directory on the screen, type PMOVE6,* and you will have access to the 
255 character input, and the filenames will still be on the screen. 

PMOVE6 may be used to copy a single file: 

PMOVE6 01pmove6/cmd 

but the time saving is really noticed when several files are to be copied: 

PMOVE6 01/cmdpmove,pmod,pvu,pfilt/flt,passno 

the above command will copy 5 files from drive to 1, and the default extension of 
/CMD will be added to all files except PFILT/FLT. 

PMOVE6 may also be used to duplicate the- same source file to several 
destination files using the rename capabilities: 

PMOVE6 01/cmd,pmove6,pmove6>pmovel,pmove6>pmove2 
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the above command will take PMOVE6/CMD from drive 0, and create 3 identical files 
on drive 1 named PMOVE/CMD, PMOVE1/CMD, and PMOVE2/CMD. 
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PERASE6 



The PERASE6 utility is a Software Bulk-Erase program. It allows the user to 
easily remove all traces of data on a diskette, and return it back to a blank state. 
Only 5" Floppy Disks may be operated on, including Single/Double Density, 
Single/Double Sided disk systems. The syntax of the PERASE6 command is: 



! PERASE6 :a ! 

! ! 

! :a = drive to be erased (0-7) ! 

! ! 

! abbr: NONE ! 



When the desired parameter has been selected, the specified drive will be read 
to determine the diskette type (cylinders, density, sides). The diskette must be 
currently formatted. If TRSDOS 6™ cannot establish the type of diskette, the 
program will abort with a "device not available" message. If there is not enough 
memory for the erase utility to operate, the program will abort with a corres- 
ponding message. If memory is sufficient, then the erase operation will proceed. You 
will be asked if you are ABSOLUTELY SURE if you want to pro- ceed with this 
operation. All data will be lost, so be sure that the correct diskette is mounted 
before you answer YES. 

Each track will be formatted with all bits off (zeroes). This will effectively 
remove all traces of sectors and data on the diskette. If you wish to abort the 
program, press the BREAK key, and the routine will abort at the completion of the 
current track. When the entire disk has been erased, it may be considered a 
completely blank disk. The program will essentially perform the same task as using 
bulk-erase magnets to delete all information from the disk. 
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PDIRT6 



The PDIRT6 program is a directory utility with the ability to read Mod III 
TRSDOS™ 1.3-formatted diskettes from within the TRSDOS 6™ operating environment. 
It allows the user to easily list files that are normally not readable via TRSDOS 6™ 
commands. This program requires that the disk to be read is previously formatted by 
TRSIII. On a Mod I, this program will only operate if the appropriate double density 
hardware is present, and corresponding TRSDOS 6™ double density disk drivers are in 
memory. The syntax of the PDIRT6 command is: 



! PDIRT6 :a,I,S,0,P 

f 

! :a = drive number (0-7, colon optional) 

! I - include INVISIBLE files 

! S - include SYSTEM files 

! = include system OVERLAYS 

! P = output to printer 

! 

! abbr: NONE 



When the desired parameters have been specified, the diskette will be read into 
memory. All VISIBLE files will automatically be listed, along with invisible and 
system files if requested. Because TRSDOS™ Mod III does not log the system 
overlays into normal directory records, but instead logs them into the last 32 bytes 
of the HIT table, if the option is specified, a list will be displayed of the system 
overlays that are currently active in the directory. Each will be listed by a 2 digit 
decimal number from 00-15 if the corresponding overlay position contains an active 
pointer. 

If PDIRT6 seems to be unable to read the target TRSDOS™ 1.3 disk correctly, 
momentarily remove the TRSDOS™ 1.3 disk from the drive and execute the TRSDOS 
6™ library command DEVICE. Then replace the TRSDOS™ 1.3 disk in the drive and 
run PDIRT6 once again. 
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PEX6 



The PEX6 utility is a diskette exerciser program. It allows the user to move the 
head to any cylinder (for alignment purposes), or to move the head in a continuous 
motion (for cleaning disk purposes). The syntax of the PEX6 command is: 



! PEX6 :a,bbb 
f 

! :a = drive number (0-7, colon optional) 

! bbb = cylinder count 

! (optional if formatted disk mounted) 

? 

! abbr: NONE 



Once the specified command has been entered, the specified drive head will be 
restored (moved to cylinder 0), and a sub-menu will be displayed. Several keys are 
recognized by the program at this point: 

D allows you to specify a new drive number 

C allows you to move the head to any cylinder 

S sets a new step rate for the drive 

A automatically step from cylinder to the top cylinder 

R move the head to cylinder 

T move the head to the top cylinder 

If the automatic mode has been set, any of the other commands will terminate 
the operation. Pressing BREAK at any time will abort the program and return control 
to TRSDOS 6™. 

If you have a head cleaning diskette, the automatic mode may be used to move 
the head across the diskette. Use directions supplied by the head cleaning 
manufacturer. You may turn the system clock on prior to entry into the program to 
have a seconds timer available. It is not advisable to run PEX6 on any one drive for 
more than 15-30 seconds at a time while the head cleaning disk is in place. Although 
most manufacturers claim that the kits are non-abrasive, too much of a good thing 
could mean trouble, and this means head wear . Please follow your kit's instructions. 
We suggest that if you only use your computer a few hours a day, then one cleaning 
a year should be sufficient. Even heavy users should only clean once a month or 
less. You'll notice that the head cleaning kit does not tell you how to actually clean 
the head. Most people simply insert the disk, and boot the system. This does not do 
the job, and of course, will only work on the drive disk. 
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PFILT6 



This is a comprehensive, user definable conversion filter that may be used for 
either input or output devices. The program will read an ASCII text file created by 
the user (via the BUILD command) to determine the parameters. The syntax of the 
PFILT6 utility is: 



! SET *aa PFILT6 Mfilespec 

! FILTER *bb *aa 

! *aa = a dummy device 

! *bb - any TRSDOS 6 defined device 

! ( = filter INPUT device (OUTPUT is the default) 

! filespec = name of the PFILT filter file 

! abbr: NONE 



This command will read the designated file and create a table of the parameters 
in the file. The entire program will then relocate itself to high memory, and protect 
itself. The format of the data file is as follows: 

A numerical value, followed by an equal sign (=), followed by the value to be 
converted to. 

If the first character is a colon (:), then the following character is interpreted 
in its ASCII form. 

If the first character is a period (.), then the following data on the line is 
considered a remark, and is not executed, although it will be displayed to the video. 

All numerical values may be entered in Binary, Decimal, Hex or Octal by 
preceding the number with B, D, H or respectively (default decimal). 

Following are examples of acceptable syntax: 

11=37 

31=h44 

o37=d44 

bll011011=ol77 

hff=hfe 

:A=a 

:Q=B 



Two sample filter files for use with PFILT6 are included on the disks, called 
CODE/JCL and DECODE/JCL. These sample files show how PFILT6 may be used for 
coding/decoding purposes. These are not supplied as sophisticated techniques, but 
merely as examples demonstrating the power of the PFILT6 filter. The syntax of the 
commands are: 



TOOLBELT Utilities 

°1983 by Breeze/QSD, Inc. 
Page 39 



SET *C0 PFILT6 (CODE 

Note that a left parenthesis is placed in front of "CODE" to indicate to PFILT6 
that it is intended to filter an input device. 

SET *CD PFILT6 DECODE 
FILTER *KI *CO 
filter *do *cd 

(The PFILT6 program uses the default extension /JCL which is the default 
extension supplied to files by the BUILD library command of TRSDOS 6™) 

Normally, you would only want to have one driver in memory at a ,time. When 
the *KI is being filtered, only upper case input will be changed, thereby allowing the 
user to enter DOS commands in lower case. Use the SPACEBAR to enter commas 
while the CODE filter is active. Following is a sample session demonstrating the 
capabilities of the system: 

set *co pfilt6 (code 

filter *ki-*co 

build test/fil 

THIS IS A TEST OF A CODED MESSAGE. <ENTER> 

<BREAK> 

reset *ki 

LIST TEST/FIL 

(SHOULD NOT BE READABLE!) 

set *cd pfilt6 decode 

filter *do *cd 

list test/fil (SHOULD NOW BE READABLE!) 

reset *do 

There is a DVORAK file on your disk, called DVORAK/JCL. This is the DVORAK 
keyboard filter file that can be used in conjunction with the PFILT6 filter. It is a 
pure ASCII data file and the syntax of the command is: 

SET *DV PFILT6 (DVORAK 
FILTER *KI *DV 

After this command, the DVORAK filter will be installed, moved to high memory, 
and protected. 
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